home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Various / Miami Amigos 90-01 (1990)(Miami Amiga Users Group)(PD)[WB].zip / Miami Amigos 90-01 (1990)(Miami Amiga Users Group)(PD)[WB].adf / Utilities / NAdr.doc < prev    next >
Text File  |  1990-01-18  |  6KB  |  134 lines
  1.                               NADR 1.0
  2.          (Yet another name and address program for the Amiga.)
  3.                   Copyright 1989 - Griff Jackson
  4.  
  5. Yes, another name and address program for the Amiga.  I guess there are
  6. some things you just can't have enough of, and name and address programs
  7. must be one of those things. 
  8.  
  9. What's included with the archive:
  10.  
  11. NAdr            - the program.
  12. NAdr.info       - the icon.
  13. NAdr.cfg        - a configuration file (more on this later)
  14. NAdr.doc        - you have probably already figured out what this is.
  15.  
  16. If you care to distribute the program, please keep all of these files
  17. together, and you're allowed to freely distribute the program as long as
  18. all of these files are kept together.
  19.  
  20. PSUEDO-LEGAL MUMBO JUMBO
  21.  
  22. On the off-chance that anyone would like to depart with their
  23. hard-earned dollars for using this program, I hereby declare that
  24. NAdr1.0 is being released as SHAREWARE.  That means if you like the
  25. program, use it and want to promote this method of software
  26. distribution (SHAREWARE) and feel really guilty about all of the blood,
  27. sweat, toil and tears that went into the program's development, then send 
  28. me money, quick.  Ten dollars, I think, would not be out of the question,
  29. but then any amount ( > $1 ) would do.  Also, I feel compelled to add 
  30. that no one is allowed to make money off of this program except me.
  31.  
  32. A Disclaimer:
  33.  
  34. The author accepts absolutely no responsibility for any harm to your
  35. computer equipment or data that this program might cause.  Now, will 
  36. it cause any harm?  I don't think so, but on the very remote chance 
  37. that something wierd should happen, you're on your own. 
  38.  
  39. HOW TO USE:
  40.  
  41. 1)  Click on the icon.  (Wow!)
  42.  
  43. 2)  Type "NAdr" from the CLI.
  44.  
  45. The rest is just about self-explanatory, but I'll attempt to explain it
  46. anyway.  Assuming you've done 1) or 2) of the above:
  47.  
  48. You get an almost 1 quarter-sized window.  It says "NAdr 1.0" at the
  49. top.  If you don't get that far, then you can stop reading now.  I
  50. don't know what's wrong.  Could be you are out of memory.  NAdr 1.0
  51. requires about 100 kilobytes of free memory.
  52.  
  53. Okay, just start keying all of your friend's, acquaintance's, family's,
  54. people whom you hardly even know addresses, names, etc...  You'll find
  55. that the up, down, right, left cursor keys work, as well as most of the
  56. rest of the keys that have Phoenician symbols embossed upon them, i. e.
  57. a-Z and 0-9, among others.  (I thought of creating a totally new character
  58. set, but I decided that what English has been using for several hundred 
  59. years was ok with me.)  Some of the keys won't do anything, and that's 
  60. just as well - you shouldn't be pressing them anyway.  Why are you doing 
  61. that?
  62.  
  63. All of the fields have a preset length (after all this is not some sort
  64. of cheapo Superbase), and you'll figure out how long they are, and the
  65. field lengths usually make sense - except where I imposed my own
  66. preferences.  Also the maximum number of names and addresses that the 
  67. program will maintain is 500.  Hope that's enough.  
  68.  
  69. Once you've keyed-in the information, you can save it to disk.  This
  70. program only works with the new CD-read/write laser disk so if you
  71. don't have one of these, you'll have to go buy one to use the program.
  72. If you can find one, it'll only cost you about $5,000.  I hope that's
  73. okay.  (Just kidding)  Click on the SAVE gadget to save your
  74. information.  Your disk drive should then spring to life with one red
  75. or green threatening eye.
  76.  
  77. Later on, if you want to find out that address for that long-lost
  78. friend, you can just start up the program and then click on the SEARCH
  79. gadget, and guess what?  Something resembling a file requester will
  80. appear in a separate window on your screen with all of your friends'
  81. names appearing in the window.  If nothing happens when you click on
  82. SEARCH, then you probably have not saved anything yet.  (Why go to the 
  83. trouble of displaying a window when there's nothing to put in it?)
  84. You can move the list up and down by placing the mouse pointer
  85. over the proportional gadget (do you speak Intuition?).  Place the mouse
  86. pointer over one of the names and click once.  (Actually, you can click 
  87. as many times as you like.  You can click yourself silly for all I care.) 
  88. The name appears in reverse video.  Okay, now click on SELECT.  Voila! 
  89. The requestor window disappears, and your friend's name, address, etc 
  90. appears in the other window.  Now you can modify the name or whatever 
  91. and save it again.  Always click on the SAVE gadget if you actually 
  92. want to save whatever you've keyed - otherwise the program thinks you 
  93. just don't care.
  94.  
  95. The ABOUT gadget just causes a requester to appear giving you a little
  96. information about the program.  Once the requester is displayed, click 
  97. on the OKAY gadget to get rid of it.
  98.  
  99. That's about all there is to it.  You can also set up a configuration
  100. file that will tell the program where your files containing the name and
  101. address info reside.  Just key in the path name using the normal '/'
  102. and ':' as appropriate, and the program will save the data there.
  103. The path name defined in the .cfg file must end with a '/' or a ':'.
  104. Otherwise it just won't work, and that's the way it is.  Oh, by the 
  105. way, the configuration file must be in the same directory as the
  106. program (NAdr).  NAdr uses two files NAdr.ndx and NAdr.dat.  You
  107. probably don't want to delete either of these files.  If you just have
  108. to delete one of them, then please delete both of them - otherwise I
  109. can't be held responsible for what might happen.  Since this is a
  110. computer program, it would be a single specific thing, but I don't know
  111. what that might be - having never tested deleting just one of the NAdr
  112. files. 
  113.  
  114. For anyone who might be interested:
  115.  
  116. I used the Benchmark Modula-2 Software Construction Set by Leon 
  117. Frenkel to develop this program.  Source code is available if you
  118. really want it.  Of course, we'd have to discuss the terms.
  119.  
  120. Griff Jackson
  121. 2205 17th Street
  122. Plano, TX 75074
  123. 214-424-3762 (voice)
  124.  
  125. PEOPLELINK: OCS180
  126. COMPUSERVE: 73447,3615 
  127.  
  128. You know, I might even consider fixing bugs or making enhancements 
  129. if you tell me about them. 
  130.  
  131. September 1989
  132.  
  133.                                                                
  134.